/**
 *  @file TranslatePrint.c
 *  @desc 实现双向链表的基本操作，并递归逆序打印链表数据（不改变链表本身顺序）
 *  @author WangBlue(wangjiping596@gmail.com)
 *  @date 2025-07-31 14:45
 *  @version 1.0
 */

#include <stdio.h>
#include <stdlib.h>

// ------------------------- 结构体定义 -------------------------

/**
 * @brief 双向链表节点结构体
 */
typedef struct node {
    int data;               ///< 数据域
    struct node *next;      ///< 指向下一个节点
    struct node *pre;       ///< 指向上一个节点
} node, *link;

// ------------------------- 基础操作 -------------------------

/**
 * @brief 创建一个带指定数据的新节点
 * @param value 节点数据
 * @return 成功返回新节点指针，失败返回 NULL
 */
link createNode(int value) {
    link newNode = (link) malloc(sizeof(node));
    if (newNode == NULL) return NULL;

    newNode->next = NULL;
    newNode->pre  = NULL;
    newNode->data = value;
    return newNode;
}

/**
 * @brief 初始化一个带头结点的空链表
 * @param head 链表头指针的地址
 */
void initNode(link *head) {
    link newNode = (link) malloc(sizeof(node));
    if (newNode == NULL) return;

    newNode->next = NULL;
    newNode->pre  = NULL;
    newNode->data = 0; // 头节点的数据域不使用
    *head = newNode;
}

// ------------------------- 插入操作 -------------------------

/**
 * @brief 头插法插入节点
 * @param head 链表头指针
 * @param value 要插入的数据值
 */
void istHead(link head, int value) {
    link newNode = createNode(value);
    if (newNode == NULL) return;

    newNode->next = head->next;
    newNode->pre = head;

    if (head->next != NULL) {
        head->next->pre = newNode;
    }

    head->next = newNode;
}

/**
 * @brief 尾插法插入节点
 * @param head 链表头指针
 * @param value 要插入的数据值
 */
void istTail(link head, int value) {
    link cur = head;

    // 遍历到链表尾部
    while (cur->next != NULL) {
        cur = cur->next;
    }

    link newNode = createNode(value);
    if (newNode == NULL) return;

    cur->next = newNode;
    newNode->pre = cur;
}

// ------------------------- 打印链表 -------------------------

/**
 * @brief 正向打印链表（不打印头节点）
 * @param head 链表头指针
 */
void printList(link head) {
    if (head == NULL || head->next == NULL) return;

    link cur = head->next;
    while (cur != NULL) {
        printf("value is %d\n", cur->data);
        cur = cur->next;
    }

    printf("\n");
}

// ------------------------- 删除操作 -------------------------

/**
 * @brief 删除指定位置的节点（位置从1开始，不含头节点）
 * @param head 链表头指针
 * @param pos 要删除的位置
 */
void delByPos(link head, int pos) {
    if (head == NULL || head->next == NULL || pos < 1) return;

    int idx = 1;
    link cur = head->next;

    // 找到第 pos 个节点
    while (cur != NULL && idx < pos) {
        cur = cur->next;
        idx++;
    }

    if (cur == NULL) return;

    // 修改前后指针，断开该节点
    if (cur->pre != NULL) {
        cur->pre->next = cur->next;
    }
    if (cur->next != NULL) {
        cur->next->pre = cur->pre;
    }

    free(cur);
}

/**
 * @brief 在指定位置插入节点（位置从1开始）
 * @param head 链表头指针
 * @param value 要插入的值
 * @param pos 插入位置（插入到第 pos 个节点之前）
 */
void insertByPos(link head, int value, int pos) {
    if (head == NULL || pos < 1) return;

    int idx = 0;
    link cur = head;

    // 找到插入位置的前一个节点
    while (cur != NULL && idx < pos - 1) {
        cur = cur->next;
        idx++;
    }

    if (cur == NULL) return;

    link newNode = createNode(value);
    if (newNode == NULL) return;

    newNode->next = cur->next;
    newNode->pre = cur;

    if (cur->next != NULL) {
        cur->next->pre = newNode;
    }
    cur->next = newNode;
}

// ------------------------- 递归逆序打印 -------------------------

/**
 * @brief 递归方式逆序打印链表中数据（不修改链表结构）
 * @param head 链表头指针
 * @note 实际打印的是从 head->next 开始的所有节点的数据，逆序输出
 */
void translate(link head) {
    if (head == NULL || head->next == NULL) return;

    // 当前节点是 head->next，保存引用
    link cur = head->next;

    // 递归进入下一节点
    translate(head->next);

    // 回溯过程中打印当前数据，实现逆序输出
    printf("value is %d\n", cur->data);
}

// ------------------------- 主函数测试 -------------------------

/**
 * @brief 主函数，测试 translate 功能（逆序打印）
 */
int main() {
    link head = NULL;

    // 初始化链表头节点
    initNode(&head);

    // 尾插方式创建链表：1 -> 2 -> 3
    istTail(head, 1);
    istTail(head, 2);
    istTail(head, 3);

    // 使用递归逆序打印链表：期望输出 3 2 1
    translate(head);
}
